<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>BIRT Report Item Extension Point</title>
<style type="text/css">@import url("file:/C:/JAHT/eclipse/plugins/org.eclipse.platform_3.3.200.v200908070800/book.css");</style>
<style type="text/css">@import url("file:/C:/JAHT/eclipse/configuration/org.eclipse.osgi/bundles/170/1/.cp/schema.css");</style>
</HEAD>
<BODY>
<H1 style="text-align:center">BIRT Report Item Extension Point</H1>
<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.birt.model.reportItemModel<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>1.0
<p></p>

<h6 class="CaptionFigColumn SchemaHeader">Description: </h6>Report Item extension point allows the user to specify how the new report item should be represented and persisted in the ROM<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
<p></p>
<p class="code SchemaDtd">&lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.reportItem">reportItem</a>+)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST extension</p>
<p class="code SchemaDtdAttlist">point&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">name&nbsp;&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.reportItem">reportItem</a> (<a href="#e.property">property</a>* , <a href="#e.propertyGroup">propertyGroup</a>* , <a href="#e.styleProperty">styleProperty</a>* , <a href="#e.method">method</a>* , <a href="#e.propertyVisibility">propertyVisibility</a>* , <a href="#e.style">style</a>* , <a href="#e.overrideProperty">overrideProperty</a>*)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST reportItem</p>
<p class="code SchemaDtdAttlist">extensionName&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">defaultStyle&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">isNameRequired&nbsp;(true | false) "false"</p><p class="code SchemaDtdAttlist">class&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">displayNameID&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">extendsFrom&nbsp;&nbsp;&nbsp;&nbsp;CDATA "ExtendedItem"</p><p class="code SchemaDtdAttlist">hasStyle&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(true | false) "true"</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
Element definition</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>extensionName</b> - Internal unique name of the element</li>
<li><b>defaultStyle</b> - Predefined style to be used for the Report Item.</li>
<li><b>isNameRequired</b> - Field to indicate if the ReportItem instance name is required.</li>
<li><b>class</b> - Name of the java class, that implements the IReportItemFactory interface.</li>
<li><b>displayNameID</b> - Resource key for display name</li>
<li><b>extendsFrom</b> - Represent the parent element definition extending from. It can be one of the report elements defined in ROM, or group element defined in ROM, or other extensions from this point. By default, it is 'ExtendedItem'.</li>
<li><b>hasStyle</b> - Marks extended item can have style or not.  if value is true, extended item can have style; else not.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.styleProperty">styleProperty</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST styleProperty</p>
<p class="code SchemaDtdAttlist">name&nbsp;CDATA #REQUIRED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - </li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.property">property</a> (<a href="#e.choice">choice</a>* , <a href="#e.elementType">elementType</a>*)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST property</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">displayNameID&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(string|number|integer|dimension|color|choice|boolean|expression|html|uri|dateTime|xml|name|float|literalString|list|resourceKey|structure|elementRef|element|contentElement) </p><p class="code SchemaDtdAttlist">detailType&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">subType&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(string|boolean|dateTime|float|integer|expression) </p><p class="code SchemaDtdAttlist">canInherit&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(true | false) "true"</p><p class="code SchemaDtdAttlist">defaultValue&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">isEncryptable&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(true | false) "false"</p><p class="code SchemaDtdAttlist">defaultDisplayName&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">isList&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(true | false) "false"</p><p class="code SchemaDtdAttlist">hasOwnModel&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(true | false) "true"</p><p class="code SchemaDtdAttlist">allowExpression&nbsp;&nbsp;&nbsp;&nbsp;(true | false) </p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - Internal unique name of the property extension element</li>
<li><b>displayNameID</b> - Resource key for the display name</li>
<li><b>type</b> - Property data type, such as integer or string. Generally, if property is of simple type(string, number, integer, dimension, color, boolean, expression, html, uri, dateTime, xml, name, float, literalString, resourceKey), then it is useless to set "subType" and "detailType" for the property; If type is "choice", then either define customized choices or set "detailType" to name of the preferred choice set in rom.def; If type is "list", the "subType" is required to determine the item type in the list value and by default its value is "string"; If type is "structure", "detailType" is required to refer a structure definition name in rom.def and set "isList" to true if value is not single; If type is "elementRef", "detailType" is required to refer an element definition name in  rom.def or an extension name of any report item extension; If type is "element", then set "isList" to true if the property value list is not single.
choice:
list:
structure, elementRef and element</li>
<li><b>detailType</b> - Detail data type, such as boolean or string. When the "type" is "choice", extension can define "detailType" to refer a choice set in original meta-data of Model; When "type" is "structure", extension must define "detailType" to refer a structure in original meta-data of Model.</li>
<li><b>subType</b> - When the "type" is "list", the "subType" is required and must be defined as one of the restriction choices. By default it is "string".</li>
<li><b>canInherit</b> - Flag indicating whether the property extension element can inherit
properties from another element</li>
<li><b>defaultValue</b> - Default value of the property extension element in the BIRT Report
Designer UI</li>
<li><b>isEncryptable</b> - The flag indicating whether this property is encrypted.</li>
<li><b>defaultDisplayName</b> - The default display name, which is used if no localized display name is found with I18N.</li>
<li><b>isList</b> - When "type" is "structure", you will define "isList" to indicate whether property value is a single structure or a structure list.</li>
<li><b>hasOwnModel</b> - Indicates whether the XML property should be treated as the extension model. Only works if the property type is XML. The default value is true.</li>
<li><b>allowExpression</b> - true indicates the property can be set as the expression. Each expression contains the value and the type. Otherwise false. The default value is false.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.propertyGroup">propertyGroup</a> (<a href="#e.property">property</a>+)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST propertyGroup</p>
<p class="code SchemaDtdAttlist">displayNameID&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">defaultDisplayName&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>displayNameID</b> - Resource key for the display name</li>
<li><b>name</b> - Internal unique name of the property group</li>
<li><b>defaultDisplayName</b> - The default display name, which is used if no localized display name is found with I18N.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.method">method</a> (<a href="#e.argument">argument</a> , <a href="#e.javaDoc">javaDoc</a>?)*&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST method</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">displayNameID&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">toolTipID&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">returnType&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">isStatic&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(true | false) "false"</p><p class="code SchemaDtdAttlist">context&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - Internal unique name of the method</li>
<li><b>displayNameID</b> - Resource key for the display name</li>
<li><b>toolTipID</b> - Resource key for tool-tip of this method</li>
<li><b>returnType</b> - Data type of the method return value</li>
<li><b>isStatic</b> - Field indicating whether this method is static or not</li>
<li><b>context</b> - Execution context of this method</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.argument">argument</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST argument</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">type&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">tagID&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - Internal unique name of this argument</li>
<li><b>type</b> - Data type of this argument, such as string or integer</li>
<li><b>tagID</b> - Resource key for tag of this argument</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.choice">choice</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST choice</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">displayNameID&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">defaultDisplayName&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
(no description available)</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - Internal unique name of the choice</li>
<li><b>value</b> - Value for this choice</li>
<li><b>displayNameID</b> - Resource key for the display name</li>
<li><b>defaultDisplayName</b> - The default display name, which is used if no localized display name is found with I18N.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.propertyVisibility">propertyVisibility</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST propertyVisibility</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">visibility&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
To set the visible level of this property when it is shown in the property sheet.</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - Internal name of the property that is set the visibility.</li>
<li><b>visibility</b> - Two options are: hide, readonly. Support to set multiple options to one property separated by ','. For example, visibility="readonly,hide".</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.style">style</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST style</p>
<p class="code SchemaDtdAttlist">name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">displayNameID&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
Extension element default style -- selector.</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - </li>
<li><b>displayNameID</b> - Resource key for the display name</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.elementType">elementType</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST elementType</p>
<p class="code SchemaDtdAttlist">name&nbsp;CDATA #REQUIRED</p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
Define all the allowed element types in this slot.</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>name</b> - Name of the element which is allowed in the slot. The name must be consistent with those defined in 'rom.def' or some other reportItem extensions.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.overrideProperty">overrideProperty</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST overrideProperty</p>
<p class="code SchemaDtdAttlist">propertyName&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">allowedChoices&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">allowedUnits&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">useOwnSearch&nbsp;&nbsp;&nbsp;(true | false) </p>&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
override allowed units.</p>
<br>
<ul class="ConfigMarkupAttlistDesc">
<li><b>propertyName</b> - Internal name of the property that is overridden by extension.</li>
<li><b>allowedChoices</b> - restricts to a sub set of choices from that defined on parent property definition. Uses ',' as seperator. For example: if only allowed 'none' and 'auto' as allowed choices, can set it as 'none, auto'.</li>
<li><b>allowedUnits</b> - units choices that use ',' as seperator. For example: if only allowed 'in' and 'cm' as allowed units, can set it as 'in,cm'.</li>
<li><b>useOwnSearch</b> - If true, the property search algorithm is controlled by the extension element self by implementing ReportItem.getProperty(). In such case, ReportItem.getProperty() returns the final effective value. The factory property value won't call ReportItem.getProperty() directly/indirectly since it may be called in ReportItem.getProperty(). 
This attribute ONLY works for ROM defined style properties. The default value is false.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.javaDoc">javaDoc</a> (#PCDATA)&gt;</p>
<p></p>
<p class="ConfigMarkupElementDesc">
JavaDoc for the method in CDATA format.</p>
<br><br>
<h6 class="CaptionFigColumn SchemaHeader">Examples: </h6>The following is an example of the Report Item extension.
<p>
<pre class="Example"><span class="code SchemaTag">

&lt;extension point=</span><span class="code SchemaCstring">&quot;org.eclipse.birt.report.engine.reportitemPresentation&quot;</span><span class="code SchemaTag">&gt;
     
&lt;reportItem 
 class=</span><span class="code SchemaCstring">&quot;org.eclipse.test.ReportItemFactoryImpl&quot;</span><span class="code SchemaTag"> 
 isNameRequired=</span><span class="code SchemaCstring">&quot;true&quot;</span><span class="code SchemaTag"> 
 extensionName=</span><span class="code SchemaCstring">&quot;TestingMatrix&quot;</span><span class="code SchemaTag">
 displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix&quot;</span><span class="code SchemaTag">&gt;

&lt;property 
  defaultValue=</span><span class="code SchemaCstring">&quot;default test&amp;amp;&amp;quot;&amp;lt;&quot;</span><span class="code SchemaTag"> 
  type=</span><span class="code SchemaCstring">&quot;string&quot;</span><span class="code SchemaTag"> 
  displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.test1&quot;</span><span class="code SchemaTag"> 
  name=</span><span class="code SchemaCstring">&quot;test1&quot;</span><span class="code SchemaTag">/&gt;
&lt;property type=</span><span class="code SchemaCstring">&quot;integer&quot;</span><span class="code SchemaTag"> 
  displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.test2&quot;</span><span class="code SchemaTag"> 
  canInherit=</span><span class="code SchemaCstring">&quot;false&quot;</span><span class="code SchemaTag"> 
  name=</span><span class="code SchemaCstring">&quot;test2&quot;</span><span class="code SchemaTag">/&gt;
&lt;property
     displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.test3&quot;</span><span class="code SchemaTag">
     name=</span><span class="code SchemaCstring">&quot;test3&quot;</span><span class="code SchemaTag">     
     type=</span><span class="code SchemaCstring">&quot;xml&quot;</span><span class="code SchemaTag">/&gt;     
&lt;property type=</span><span class="code SchemaCstring">&quot;choice&quot;</span><span class="code SchemaTag"> 
  displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.test5&quot;</span><span class="code SchemaTag"> 
  canInherit=</span><span class="code SchemaCstring">&quot;false&quot;</span><span class="code SchemaTag"> 
  name=</span><span class="code SchemaCstring">&quot;test5&quot;</span><span class="code SchemaTag">&gt;
  &lt;choice value=</span><span class="code SchemaCstring">&quot;one&quot;</span><span class="code SchemaTag"> 
   displayNameID=</span><span class="code SchemaCstring">&quot;Choices.test5.choice1&quot;</span><span class="code SchemaTag"> 
   name=</span><span class="code SchemaCstring">&quot;choice1&quot;</span><span class="code SchemaTag">/&gt;
  &lt;choice value=</span><span class="code SchemaCstring">&quot;two&quot;</span><span class="code SchemaTag"> 
   displayNameID=</span><span class="code SchemaCstring">&quot;Choices.test5.choice2&quot;</span><span class="code SchemaTag"> 
   name=</span><span class="code SchemaCstring">&quot;choice2&quot;</span><span class="code SchemaTag">/&gt;
  &lt;choice value=</span><span class="code SchemaCstring">&quot;three&quot;</span><span class="code SchemaTag"> 
   displayNameID=</span><span class="code SchemaCstring">&quot;Choices.test5.choice3&quot;</span><span class="code SchemaTag"> 
   name=</span><span class="code SchemaCstring">&quot;choice3&quot;</span><span class="code SchemaTag">/&gt;
&lt;/property&gt;
&lt;propertyGroup name=</span><span class="code SchemaCstring">&quot;group1&quot;</span><span class="code SchemaTag"> 
  displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.group1&quot;</span><span class="code SchemaTag">&gt;
  &lt;property type=</span><span class="code SchemaCstring">&quot;string&quot;</span><span class="code SchemaTag">
   displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.test6&quot;</span><span class="code SchemaTag">
   name=</span><span class="code SchemaCstring">&quot;test6&quot;</span><span class="code SchemaTag">/&gt;
  &lt;property type=</span><span class="code SchemaCstring">&quot;integer&quot;</span><span class="code SchemaTag">
   displayNameID=</span><span class="code SchemaCstring">&quot;Element.TestingMatrix.test7&quot;</span><span class="code SchemaTag">
   name=</span><span class="code SchemaCstring">&quot;test7&quot;</span><span class="code SchemaTag">/&gt;
&lt;/propertyGroup&gt;
  &lt;propertyVisibility name=</span><span class="code SchemaCstring">&quot;bookmark&quot;</span><span class="code SchemaTag"> propertyVisibility=</span><span class="code SchemaCstring">&quot;hide&quot;</span><span class="code SchemaTag">/&gt;
  &lt;propertyVisibility name=</span><span class="code SchemaCstring">&quot;InvalidProperty&quot;</span><span class="code SchemaTag"> propertyVisibility=</span><span class="code SchemaCstring">&quot;hide&quot;</span><span class="code SchemaTag">/&gt;
  &lt;propertyVisibility name=</span><span class="code SchemaCstring">&quot;dataSet&quot;</span><span class="code SchemaTag"> propertyVisibility=</span><span class="code SchemaCstring">&quot;readonly&quot;</span><span class="code SchemaTag">/&gt;
  &lt;propertyVisibility name=</span><span class="code SchemaCstring">&quot;test3&quot;</span><span class="code SchemaTag"> propertyVisibility=</span><span class="code SchemaCstring">&quot;hide&quot;</span><span class="code SchemaTag">/&gt;  
&lt;/reportItem&gt;
&lt;/extension&gt;

</span></pre>
</p>
<p></p>

<h6 class="CaptionFigColumn SchemaHeader">API Information: </h6>If the extended Report Item stores properties in its own model; i.e its own way of storing data then it must satisfy the following requirements<br>
- serialize/deserialize as part of the report design file<br>
- support undo/redo<br>
- support generic property sheet<br>
<br>
In order to acheive this, the report item extension must implement some of the interfaces defined in the <i>org.eclipse.birt.report.model.api.extension</i> package. See the package's JavaDoc documentation and API interfaces for more information.<br>
 <br>
The classes/interfaces to be extend/implement are:<br>
- ReportItem ( required )<br>
- ReportItemFactory ( required )<br>
- ElementCommand ( optional, extend this class to suport undo/redo operation ). Extend ElementCommand class and integrate with the command stack in the  IReportItem::setProperty() method implementation<br>
- IPropertyDefinition, IChoiceDefinition ( optional, implement this class to integrate with the generic property sheet in the designer )<br>
- IMessages ( optional, implement this class to support externalized strings )<br>
<p></p>

<h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>The plugin org.eclipse.birt.chart.reportitem, supplied with the BIRT installation, provides a good example for implementing an report item extension.
<p></p>

<br>
<p class="note SchemaCopyright">
Copyright (c) 2005 Actuate Corporation. All rights reserved. This program and 
the accompanying materials are made available under the terms of the Eclipse 
Public License v2.0 which accompanies this distribution, and is available at 
http://www.eclipse.org/legal/epl-2.0.html

Contributors: Actuate Corporation - initial API and implementation

</p>
</BODY>
</HTML>
